home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / perl5 / File::Spec.z / File::Spec
Encoding:
Text File  |  2002-10-03  |  3.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. FFFFiiiilllleeee::::::::SSSSppppeeeecccc((((3333))))                                                    FFFFiiiilllleeee::::::::SSSSppppeeeecccc((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      File::Spec - portably perform operations on file names
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      use File::Spec;
  13.  
  14.      $x=File::Spec->catfile('a','b','c');
  15.  
  16.      which returns 'a/b/c' under Unix.
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      This module is designed to support operations commonly performed on file
  20.      specifications (usually called "file names", but not to be confused with
  21.      the contents of a file, or Perl's file handles), such as concatenating
  22.      several directory and file names into a single path, or determining
  23.      whether a path is rooted. It is based on code directly taken from
  24.      MakeMaker 5.17, code written by Andreas Koenig, Andy Dougherty, Charles
  25.      Bailey, Ilya Zakharevich, Paul Schinder, and others.
  26.  
  27.      Since these functions are different for most operating systems, each set
  28.      of OS specific routines is available in a separate module, including:
  29.  
  30.              File::Spec::Unix
  31.              File::Spec::Mac
  32.              File::Spec::OS2
  33.              File::Spec::Win32
  34.              File::Spec::VMS
  35.  
  36.      The module appropriate for the current OS is automatically loaded by
  37.      File::Spec. Since some modules (like VMS) make use of OS specific
  38.      facilities, it may not be possible to load all modules under all
  39.      operating systems.
  40.  
  41.      Since File::Spec is object oriented, subroutines should not called
  42.      directly, as in:
  43.  
  44.              File::Spec::catfile('a','b');
  45.  
  46.      but rather as class methods:
  47.  
  48.              File::Spec->catfile('a','b');
  49.  
  50.      For a reference of available functions, pleaes consult the
  51.      _F_i_l_e::_S_p_e_c::_U_n_i_x manpage, which contains the entire set, and inherited by
  52.      the modules for other platforms. For further information, please see the
  53.      _F_i_l_e::_S_p_e_c::_M_a_c manpage, the _F_i_l_e::_S_p_e_c::_O_S_2 manpage, the
  54.      _F_i_l_e::_S_p_e_c::_W_i_n_3_2 manpage, or the _F_i_l_e::_S_p_e_c::_V_M_S manpage.
  55.  
  56. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  57.      File::Spec::Unix, File::Spec::Mac, File::Spec::OS2, File::Spec::Win32,
  58.      File::Spec::VMS, ExtUtils::MakeMaker
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. FFFFiiiilllleeee::::::::SSSSppppeeeecccc((((3333))))                                                    FFFFiiiilllleeee::::::::SSSSppppeeeecccc((((3333))))
  71.  
  72.  
  73.  
  74. AAAAUUUUTTTTHHHHOOOORRRRSSSS
  75.      Kenneth Albanowski <_k_j_a_h_d_s@_k_j_a_h_d_s._c_o_m>, Andy Dougherty
  76.      <_d_o_u_g_h_e_r_a@_l_a_f_c_o_l._l_a_f_a_y_e_t_t_e._e_d_u>, Andreas Koenig
  77.      <_A._K_o_e_n_i_g@_f_r_a_n_z._w_w._T_U-_B_e_r_l_i_n._D_E>, Tim Bunce <_T_i_m._B_u_n_c_e@_i_g._c_o._u_k>. VMS
  78.      support by Charles Bailey <_b_a_i_l_e_y@_n_e_w_m_a_n._u_p_e_n_n._e_d_u>.  OS/2 support by
  79.      Ilya Zakharevich <_i_l_y_a@_m_a_t_h._o_h_i_o-_s_t_a_t_e._e_d_u>. Mac support by Paul Schinder
  80.      <_s_c_h_i_n_d_e_r@_p_o_b_o_x._c_o_m>.
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.